Release 10.1A: OpenEdge Development:
Progress 4GL Reference

ADD-FIRST( ) method

Adds one or more items to the top of a combo box or selection list.

Return type: LOGICAL

Applies to: COMBO-BOX widget, SELECTION-LIST widget

Syntax

ADD-FIRST ( { item-list | label , value } )

item-list

A character-string expression that represents one or more items, delimiter-separated.

label

A character-string expression that represents the label of a label-value pair.

value

The value Progress assigns to the field or variable if the user selects the corresponding label.

The delimiter is the value of the DELIMITER attribute, which defaults to comma. If the SORT attribute is TRUE, Progress sorts new items by label before adding them to the widget. If the operation is successful, ADD-FIRST returns TRUE.

Notes

If the widget’s entries consist of single items, use item-list. If the widget’s entries consist of label-value pairs, use label and value.
If the widget’s entries consist of single items, each call to ADD-FIRST can add multiple entries. If the widget’s entries consist of label-value pairs, each call to ADD-FIRST can add one entry.

Examples

The following examples modify widgets whose entries consist of single items:

return-code = my-widget-hdl:ADD-FIRST("Seoul").

return-code = my-widget-hdl:ADD-FIRST("Bogota, Seoul, Los Angeles").

The following example modifies a combo-box widget of type INTEGER whose entries consist of label-value pairs:

return-code = my-widget-hdl:ADD-FIRST("Bogota", 15).